home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / epsilon.arc / VERSIONS.ARC / VERSIONS.DOC < prev    next >
Text File  |  1986-04-06  |  3KB  |  86 lines
  1.                Cursory Documentation On
  2.             Epsilon File Versions
  3.                  Version T1.0
  4.  
  5. Copyright (c) 1986 by David Dyer-Bennet
  6. Permission for non-commercial use is hereby granted; all other
  7. rights are reserved.
  8.  
  9. Written by David Dyer-Bennet
  10. Terrabit Software
  11. 4242 Minnehaha Ave S
  12. Minneapolis, MN 55406
  13.  
  14. Usenet: ...ihnp4!umn-cs!starfire!ddb
  15. Fido: Sysop of Fido 14/341, The Terraboard, (612) 721-8967 3/12/24 24hrs
  16. Telephone: (612) 721-8800 NOT 24 hrs!  More like noon to midnight
  17. Compuserve: 74756,723
  18.  
  19. Version T1.0 of Epsilon File Versions is a PRE-RELEASE version.  I started
  20. writing it 5-Apr-86, and this version is being released 6-Apr-86.  I'm
  21. using it myself, and it seems to work (except for purge, which isn't 
  22. written yet), but use at your own risk!
  23.  
  24. 1.0  Multiple File Versions
  25.  
  26. People who have used TOPS-20, VMS, good versions of Un*x, and other
  27. superior operating systems are aware of how convenient it is to have
  28. the system maintain multiple versions of files -- generally, the most
  29. recent n versions.
  30.  
  31. This package makes that capability available in a limited way to
  32. users of the Epsilon text editor from Lugaru Software.
  33.  
  34. 1.1  How I did it
  35.  
  36. Simple.  A file that exists in 4 versions, numbered 0 through 3,
  37. would be represented as 5 files on disk.  Let's say that the file is
  38. "play.mss", a manuscript file.  Let's further say that you've chosen
  39. the character "M" to identify old versions of manuscript files.
  40.  
  41. Then you would have the following files:
  42.  
  43.     Name        Description
  44.  
  45.     play.m00    Version 0
  46.     play.m01    Version 1
  47.     play.m02    Version 2
  48.     play.mss    Version 3
  49.     play.mzz    Special file used for keeping track of the
  50.             others.
  51.  
  52. Each class of files that you want to use versioning on should have
  53. its own major mode.  The setup that tells epsilon that this files
  54. should be versioned takes place most easily in the mode function (for
  55. the example above, that would be "mss-mode").
  56.  
  57. An example of mss mode is provided in this archive.
  58.  
  59. 1.2  Commands
  60.  
  61. There are a few commands intended for direct use:
  62.  
  63. version-statistics: Displays the version under which the current
  64. buffer contents would be saved if you gave the command now, the full
  65. file name, and the character used as the first character of all the
  66. special extensions.
  67.  
  68. un-version: Disables versioning of the current file.
  69.  
  70. purge: NOT YET IMPLEMENTED.  This will eventually reduce the number
  71. of copies of a file stored to a specified number, and set those to
  72. the lowest available version numbers.  Without this command, things
  73. will die when you exceed 100 versions (it will give you a message to
  74. that affect, rather than breaking things).
  75.  
  76. 2.0  Installation
  77.  
  78. The files.e provided is intended to replace the one distributed with
  79. Epsilon.  Actually, only the save-files function is changed.  The
  80. load-bytes function was removed to make it easy to replace the
  81. original version with this one on the fly.
  82.  
  83. To install this, simply read in the bytecode files, and save a new
  84. state file.  Be sure not to lose your old reliable copies of files.e
  85. and epsilon.sta!
  86.